home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Text Processing / JCONV-DD ver.1.8 ƒ / *Must read this to use* next >
Text File  |  1994-06-16  |  13KB  |  384 lines
  1. JCONV-DD -- a JIS<->SJIS<->EUC converter
  2. ========================================
  3. FILE: JCONV-DD
  4. ver.: 1.8
  5. Type: Application
  6. Author: Natsu Sakimura
  7. Date: 1994.06.16
  8. System Requirement: System 7.0 or later
  9. Distribution: Donateware (see Asking your favour: 
  10.               section below for terms and conditions) 
  11.  
  12. *** This document is formatted in SE-TEXT format. ***
  13. *** You can use EasyView for more convenient browsing ***
  14.  
  15.     =================
  16.     TABLE OF CONTENTS
  17.     =================
  18. Conditions for the use of JCONV-DD
  19. Description:
  20. New In This Version:
  21. Usage:
  22. Result:
  23. Caution:
  24. Known Bugs:
  25. Disclaimer:
  26. Contact address:
  27. Distribution
  28. Notes:
  29. Acknowledgement:
  30. Asking your favour:
  31. Version History:
  32. Future Directions:
  33. Miscellaneous:
  34. Other utilities from the same author
  35.  
  36. Conditions for the use of JCONV-DD
  37. ----------------------------------
  38.     TO READ THIS DOCUMENT THOROUGHLY. 
  39.     SEND IN THE "User Registration" WHEN YOU DECIDE TO 
  40.     KEEP JCONV-DD. 
  41.     
  42. Description:
  43. ------------
  44.     JCONV-DD is a drag & drop application which performs 
  45.     the conversion of JIS, SJIS and EUC files. It 
  46.     auto-detects the encoding scheme of the file which was 
  47.     dropped.
  48.     JCONV-DD allows the default output code and EOL 
  49.     characters settings for each of New-JIS, Shift-JIS, 
  50.     EUC input files so that users do not need to specify 
  51.     neither input nor output code nor the EOL characters 
  52.     once the default has been set. For other features, 
  53.     please refer to the "Feature Set" file. 
  54.  
  55. New In This Version:
  56. --------------------
  57.    • Unified the features of CRLF. Now you can deal with 
  58.      ASCII text and broken JIS text alike.  
  59.  
  60. Usage:
  61. ------
  62.  *************************************************************
  63.  **    Before start using JCONV-DD version 1.6.2, users are    **
  64.  **    strongly recommended to set up the default behavior for ** 
  65.  **    the JCONV-DD.                                           **
  66.  *************************************************************
  67.     
  68.     To do so, just double click the JCONV-DD icon while 
  69.     pressing control key down until a dialog box appears. 
  70.     In the dialog box, you can set the default output 
  71.     code for each of JIS, SJIS, and EUC files. You can 
  72.     also set the EOL characters and creators to use in 
  73.     the output file. 
  74.     
  75.     From version 1.6.3, you are now able to choose between 
  76.     ESC(B and ESC(J as the so called "Kanji-Out" string in 
  77.     the preference dialog. 
  78.     
  79.     Please note that the EOL characters and the file 
  80.     creator depends upon the input file's code. This 
  81.     specification may be arguable, but this seems to 
  82.     be the best compromise to me at the moment. 
  83.     
  84.     The default setting at the time of shipping is:
  85.     ---------------------------------------
  86.     Input    Output      EOL     creator
  87.     ---------------------------------------
  88.     JIS      Shift-JIS    CR      Edt7
  89.     SJIS    New-JIS     LF      CRLF
  90.     EUC     Shift-JIS    CR      YoED
  91.     ---------------------------------------
  92.     
  93.     Other creators I recommend is mdos for EOL==CRLF. 
  94.     As long as you have Apple file exchange, you will 
  95.     get the proper icon for mdos. 
  96.     
  97.     Once you have done the setup, just drag & drop one or more 
  98.     text files/folders onto JCONV-DD. JCONV-DD will automatically 
  99.     detect the input code, then converts the file according to 
  100.     the rule you have set in the preference dialog. 
  101.     
  102.     To override the default behavior, press COMMAND_KEY while 
  103.     dropping the files. A dialog comes up and through it, 
  104.     you can set up the input and output code as you desire.
  105.     
  106.     You can also change the output file's code by pressing one of 
  107.     the modifier keys.
  108.     
  109.     ----------- --------------------------
  110.         Key         Output
  111.     ----------- --------------------------
  112.     SHIFT_KEY    SHIFT-JIS
  113.     OPTION_KEY   EUC
  114.     SPACE_KEY    New-JIS
  115.     COMMAND_KEY  Specify through dialog
  116.     CONTROL_KEY  Setup the preference**
  117.     ----------- --------------------------
  118.     
  119.  ** I strongly recommend you to setup the preference before you 
  120.     start using JCONV-DD. It will save a lot of time later.
  121.     
  122.     You must continue pressing the modifier key until the conversion 
  123.     of the first file begin. (All the other files will be converted 
  124.     to the same code as the first file.)
  125.     
  126.     You can also open the application and select the files from 
  127.     Standard File dialog, but it doesn't make much sense, 
  128.     does it? The modifier key strategy also works here.
  129.  
  130. Result:
  131. -------
  132.     File with the desired encoding: Default is New-JIS.
  133.     The name of the output file will have the extension 
  134.     showing its code. e.g., if the original file was 
  135.     myfile.txt, then output will be something like 
  136.      myfile.new  -- New JIS
  137.      myfile.sjs  -- Shift JIS
  138.      myfile.euc  -- EUC.
  139.      myfile.old  -- Old-JIS
  140.      myfile.nec  -- NEC-JIS
  141.      myfile.rem  -- JIS without ESC code
  142.     
  143.     If you select Check Code Only mode, JCONV-DD will display 
  144.     the file's code.
  145.     
  146. Caution:
  147. --------
  148.     It has not been tested much.
  149.     *** IT IS NOT COMPATIBLE WITH SYSTEMS PRIOR TO SYSTEM 7.0 ***
  150.  
  151. Known Bugs:
  152. -----------
  153.      If you drop a folder onto JCONV-DD ver.1.8, ALL the files 
  154.      will be processed, including applications! 
  155.  
  156. Disclaimer:
  157. ---------- 
  158.     THE PROGRAMME IS PROVIDED AS IS. ABSOLUTELY NO RESPONSIBILITY 
  159.     WILL BE TAKEN BY THE AUTHOR FOR WHATEVER THE CONSEQUENCE OF 
  160.     THIS APPLICATION.
  161.  
  162. Contact address:
  163. ----------------
  164.     Please e-mail any suggestions to:
  165.         sakimura@sscl.uwo.ca 
  166.  
  167. Distribution
  168. ------------
  169.     You can freely redistribute this package provided you do so in 
  170.     the original packaging, i.e., don't change any file in the 
  171.     package. You must not charge any money for the redistribution 
  172.     except for the nominal charge for the disk, etc. 
  173.  
  174.     All the files are copyrighted and not in the public domain:
  175.     It is a DONATEWARE(see asking your favour section for details)! 
  176.  
  177. Notes:
  178. ------ 
  179.     This version of JCONV-DD implements subset of jconv ver.3.0 
  180.     by Ken Lunde. I wrote this because, from time to time, I 
  181.     had to convert between sjis and jis files. I wanted to do it 
  182.     without much interaction. I thought a drag & drop with only 
  183.     a few options will be nice. The reason for the public release 
  184.     was to help the people who has the similar needs and to 
  185.     ask your favour to donate if you have some extra monay to 
  186.     the people in needs. 
  187.  
  188.     The features dropped from jconv ver.3.0 are:
  189.     i. JIS/EUC/SJIS table
  190.     ii. verbose mode
  191.     
  192. Acknowledgement:
  193. ----------------
  194.     I would like to thank Mr.Ken Lunde for making the source code  
  195.     of jconv freely available. Also, I would like to thank Mr.Troy 
  196.     Anderson for supplying "File Dropper" application shell 
  197.     without any license fee. The folder icon was created by 
  198.     Mr.Fumio Rokkaku. 
  199.  
  200. Asking your favour:
  201. -------------------
  202.     If you liked it and decided to use it, please make 
  203.     donations to an organization like UNHCR or "Medicines 
  204.     sans Frontieres" to help peaople in needs. 
  205.     
  206.     You can do it in 4 ways. 
  207.     
  208.     1) Find the organization near your place and donate. 
  209.        *** In this case, please send me the name and 
  210.        address of the organization to me. I am trying to 
  211.        compile a list of such organizations so that 
  212.        I can help people to get contact with these 
  213.        organizations easier. ( PLEASE STATE EXPLICITLY 
  214.        WHAT THE ORGANIZATION IS FOR!)
  215.     
  216.     2) Donate to the organizations in the attached list 
  217.        and send me to which organization you have donated 
  218.        (with or without amount. I believe your honesty.) 
  219.        
  220.     3) Send cheque or money order to me. Then, it will 
  221.        be forwarded to MSF. 
  222.        
  223.     4) If you are too poor to donate, then you can provide 
  224.        me with the name/address/phone number of a 
  225.        charitable organization of your area. 
  226.  
  227.     If you send in the "User Registration," then you will be 
  228.     a registered user for 1 year from the registration date. 
  229.     I will try to send the following to the internet connected 
  230.     registered users.  
  231.      
  232.       1) Bug reports
  233.       2) Notice of new version release.
  234.     
  235.     My address is: 
  236.     
  237.     Natsu Sakimura
  238.     1 Jacksway Cres., Suite 320
  239.     London, Ontario N5X3T5
  240.     CANADA
  241.     
  242.     E-mail: sakimura@sscl.uwo.ca
  243.  
  244. Version History:
  245. ----------------
  246. 0.2b    The first release [1993.08.26].
  247. 1.3     The second release [1993.08.31]. New features:
  248.         • Added command mode to specify 
  249.        (1) Input Code [New-JIS, Old-JIS, NEC-JIS, EUC, Shift-JIS]
  250.        (2) Output Code [New-JIS, Old-JIS, NEC-JIS, EUC, Shift-JIS]
  251.        (3) Other modes:[JIS-Repair, Delete ESC, Force Delete ESC,
  252.              Hankaku to Zenkaku(To Full Size), Check Code Only]
  253.      • New algorithms which came with jconv ver.3.0.
  254.        [BTW, jconv 3.0 is available from info-mac archive 
  255.        in the util directory if I remember correctly. ]
  256. 1.4b1    The third release [1993.09.07]. 
  257.    • Disabled the progress bar for the smaller files (<5K).
  258.    • Disabled the "smooth" progress bar for the larger files.
  259.       These are for the sake of speed.
  260.    • Added behavior control mode, i.e., preference setting for 
  261.       default behavior of JCONV-DD.
  262.    • Added a modifier key to specify New-JIS for output to 
  263.       override the user setting.
  264.  
  265. 1.4b2    The Second evolution of version 1.4. 
  266.    • Changed the specification so that it will truncate the 
  267.      filename of the output when it is too long, so that now 
  268.      it works even for a very long file name. 
  269.  
  270. 1.4b3    The Third evolution of version 1.4. [1993.09.25]
  271.    • Fixed a bug which caused a crash in System7.0.1 when 
  272.      using in Command or preference mode. 
  273.  
  274. 1.4b5    [1993.10.18]
  275.    • Fixed a bug which did not allow it to process more 
  276.      than 7 files at a time.
  277.  
  278. 1.5.0    [1993.10.30]
  279.    • Changed the default behavior control dialog so that it is
  280.      now possible to change the default behavior according to 
  281.      the code of the input file. 
  282.  
  283. 1.6.0    [1993.12.26]
  284.    • Now it allows the selection of the EOL characters 
  285.      depending upon the input file's encoding scheme. 
  286.       
  287. 1.6.1    [1993.12.29]
  288.    • Fixed the bugs caused the euc conversion fail and 
  289.      the file creator not properly set in Repair JIS 
  290.      mode. Also fixed the bug which caused the command 
  291.      mode to be ineffective. The Japanese document had 
  292.      fixed some typos. 
  293.  
  294. 1.6.2    [1994.02.21]
  295.    • Now creates a unique file name so that it will not 
  296.      collide with the existing files. 
  297.    • Support of Balloon help for preference dialog and 
  298.      the finder icon are added. 
  299.      
  300. 1.6.3    [1994.03.27]
  301.    • Fixed the bug which caused the loss of ascii 
  302.      characters in SJIS->SJIS conversion. 
  303.    • Added a check box in the prefs dialog to allow 
  304.      choice between ESC(B and ESC(J in the output 
  305.      New & Old JIS file. 
  306.    • Added a check box in the prefs dialog to allow 
  307.      choice between new file generation or in place  
  308.      conversion. 
  309.    • Changed the finder help balloon to use styled text. 
  310.    • Fixed the bug so that now the progress bar is 
  311.      displayed properly on a B/W monitor. 
  312.  
  313. 1.7.0     [1994.04.24]
  314.    • Now help balloons are displayed properly within the 
  315.      preference dialogue box. 
  316.    • Preference dialogue box became accessible from the 
  317.      File menu, too. 
  318.    • Setting the creator for the output file can now be 
  319.      done through the standard file dialogue. 
  320.      
  321. 1.7.1     [1994.04.28]
  322.    • Improved the Kanji Code detection algorithm so that 
  323.      dection of EUC and SJIS Hankaku Kana became better.
  324.  
  325. 1.7.3    [1994.04.30]
  326.    • Fixed the bug which caused an infinite-loop when 
  327.      folder is dropped without specifying the in-place 
  328.      conversion option. (1.7.3)
  329.    • Fixed the bug in the preference dialogue. 
  330. 1.8      [1994.06.16]
  331.    • Unified the features of CRLF. Now you can deal with 
  332.      ASCII text and broken JIS text alike.  
  333.   
  334.      
  335. Future Directions:
  336. ------------------
  337. In version 2.0, multiple Kanji codes in a single input 
  338. file will be supported. 
  339.  
  340. I am thinking of adding the following capabilities in the 
  341. future:
  342.  
  343. 1) Resource folk preservation. 
  344.  
  345. Miscellaneous:
  346. --------------
  347.    As a default, JCONV-DD accepts only the text files 
  348.    and Folders. However, you can change this behavior 
  349.    by fiddling with ResEdit. Open a BNDL resource 128 
  350.    and add a new file type. Then, drop it on a utility 
  351.    like Save-a-BNDL or rebuild the desktop. This would 
  352.    do the trick. Note that JCONV-DD will through away 
  353.    all the resource fork. Do this only with caution 
  354.    and if you are absolutely sure on what you are doing. 
  355.    
  356.    There are several icons supplied since ver.1.6. 
  357.    If you set the creator CRLF, then crlf icon will 
  358.    appear even if you don't have CRLF. (You may need 
  359.    to rebuild the desktop.) 
  360.    If you set the creator JCNV, then JIS file icon 
  361.    will appear. 
  362.    You can browse through the icon resources by ResEdit 
  363.    to see more icons supplied with JCONV-DD.
  364.  
  365. Other utilities from the same author
  366. ------------------------------------
  367. CRLF : Converts file format among UNIX<->Mac<->IBM (well, more 
  368.        formally, changes the end of line character among 
  369.        LF<->CR<->CRLF) on Drag & Drop. It converts the file 
  370.        "in place", i.e., it does not create a new file with another 
  371.        extension. Instead of the extension, you will be able to 
  372.        figure out the file's format by the icon.
  373.        
  374.        It does not break up the Japanese code like 
  375.        some other similar utility does. You can set up the 
  376.        default behavior just like JCONV-DD, so you would not need 
  377.        the interaction after then. 
  378.        
  379.        Written in Think C ver.6.0. 
  380.        [DonateWare] 
  381.        
  382. Rescue George : A puzzle
  383.  
  384. <End of ReadMe>